home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / system / 4dosnt25.zip / UPDAT25.DOC < prev    next >
Text File  |  1994-10-12  |  22KB  |  582 lines

  1.  
  2.  
  3.  
  4.                                   JP Software
  5.  
  6.                    4DOS for Windows NT Update Documentation
  7.  
  8.                         Version 2.5 -- October 12, 1994
  9.  
  10.    [Copyright 1993 - 1994, JP Software Inc., All Rights Reserved. 
  11.    Published by JP Software Inc., P.O. Box 1470, E. Arlington, MA 02174
  12.    USA, (617) 646-3975.  4DOS is a registered trademark of JP Software Inc. 
  13.    Windows NT is a trademark of Microsoft Corporation.  Other product and
  14.    company names are trademarks of their respective owners.]
  15.  
  16.    [PLEASE NOTE:  This product is named "4DOS", and this version is more
  17.    fully described as "4DOS for the Windows NT Operating System".  For
  18.    brevity, in this file and throughout our documentation we refer to "4DOS
  19.    for Windows NT", to "4DOS/NT", or to the program file name, 4NT.EXE or
  20.    4NT.  When "4DOS" is used by itself the reference is to our DOS product. 
  21.    See ORDERINF.DOC for information on 4DOS, 4OS2, and all JP Software
  22.    products.]
  23.  
  24.    There are dozens of new features in this latest release of 4DOS/NT! 
  25.    Check through this file for a comprehensive list of what's changed since
  26.    version 2.0.  This file does not explain how to use the new features. 
  27.    Be sure to check the Reference Manual or online help for complete
  28.    details on each feature.  If you are new to 4DOS/NT with version 2.5,
  29.    you can skip this file entirely, and begin with the 4DOS for Windows NT
  30.    Introduction and Installation Guide.
  31.  
  32.    This file is divided into the following sections:
  33.  
  34.           General Features and Enhancements
  35.           Startup, Initialization, and 4DOS.INI
  36.           Command Line Editing and History
  37.           Aliases
  38.           Command Changes and Enhancements
  39.           Variables and Variable Functions
  40.           Technical and Compatibility Enhancements
  41.           Bugs Fixed
  42.  
  43.    Major new features and those which affect most users are marked with
  44.    "**" in the lists below.  Other items discuss smaller or more technical
  45.    changes.
  46.  
  47.    This file is formatted at 58 lines per page, and contains form feeds and
  48.    page footers.  It can be viewed with a file viewer such as the 4DOS/NT
  49.    LIST command, or printed on most PC printers using the command:
  50.  
  51.                   copy updat25.doc prn
  52.  
  53.    Printing it with a program that formats the pages is not likely to work
  54.    due to the formatting included in the file.
  55.                                                                (10/94-2.5A)
  56.  
  57.  
  58.  
  59.    4DOS/NT 2.5  [10-12-94]        UPDAT25.DOC                        page 1
  60.  
  61.  
  62.  
  63.                             4DOS/NT 2.5 Change List
  64.  
  65.  
  66.    General Features and Enhancements
  67.    ---------------------------------
  68.  
  69.    => **  The maximum file description length (set with the DescriptionMax
  70.           directive in the .INI file) has been increased to 511 characters.
  71.  
  72.    => **  Colors can now be specified as either digits (0-15) or the color
  73.           name, i.e. "COLOR 15 on 1" for bright white on blue.  This should
  74.           help those who are running out of room for ColorDir
  75.           specifications.  The colors are:
  76.  
  77.               0:  Black               8:   Gray
  78.               1:  Blue                9:   Bright blue
  79.               2:  Green               10:  Bright green
  80.               3:  Cyan                11:  Bright cyan
  81.               4:  Red                 12:  Bright red
  82.               5:  Magenta             13:  Bright magenta
  83.               6:  Brown               14:  Yellow
  84.               7:  White               15:  Bright white
  85.  
  86.    =>     @ATTRIB and the /A:xxx switches on all commands will ignore
  87.           underlines in the attribute string, for example "/A:R_S" is a
  88.           valid switch for the commands which support /A.  This allows you
  89.           to use the results returned by @ATTRIB in a command or another
  90.           call to @ATTRIB.
  91.  
  92.    =>     Added more complete support for decimal and negative numbers in
  93.           DO and IF / IFF comparisons.
  94.  
  95.    =>     Wildcard matching supports "[]" to mean "match only if nothing's
  96.           there."  This is useful for things like:
  97.  
  98.                   dir /i"[]" *.btm
  99.  
  100.           to display only the .BTM files that do NOT have a description.
  101.  
  102.    =>     Date and time ranges have a new option to select the "Last
  103.           Access" (a) or "Created" (c) fields on HPFS and NTFS drives.  For
  104.           example, to select files last accessed yesterday and today:
  105.  
  106.                   /[da-1]
  107.  
  108.    =>     PATH searching uses only semicolons and commas as possible path
  109.           delimiters (formerly it also accepted spaces and tabs).  This
  110.           helps to avoid problems with unquoted HPFS long names in the
  111.           PATH.
  112.  
  113.  
  114.  
  115.  
  116.  
  117.    4DOS/NT 2.5  [10-12-94]        UPDAT25.DOC                        page 2
  118.  
  119.  
  120.    Startup, Initialization, and 4DOS.INI
  121.    -------------------------------------
  122.  
  123.    =>     There is a new startup switch, /LD, to force a local directory
  124.           history.
  125.  
  126.    =>     There are a number of new .INI file directives:
  127.  
  128.               DescriptionName = File:  Filename to use for file
  129.               descriptions, defaults to DESCRIPT.ION.  This is intended
  130.               primarily for BBS sysops who want to use FILES.BBS for file
  131.               descriptions.
  132.  
  133.               DirHistory = nnnn (256):  Size of the directory history in
  134.               bytes, from 128 to 2048.
  135.  
  136.               EvalMax = nnnn (8):  Maximum number of digits after the
  137.               decimal point in values returned by @EVAL (0-8).
  138.  
  139.               EvalMin = nnnn (0):  Minimum number of digits after the
  140.               decimal point in values returned by @EVAL (0-8).  EvalMin
  141.               will be ignored if it is larger than EvalMax.
  142.  
  143.               LocalDirHistory = [Yes|No]:  Sets local or global directory
  144.               history.  The default is Yes for 4DOS, No for 4OS2 and
  145.               4DOS/NT.
  146.  
  147.  
  148.    Command Line Editing and History
  149.    --------------------------------
  150.  
  151.    => **  Directory histories are inherited, and can be global, like
  152.           aliases and command history (also see the new LocalDirHistory
  153.           directive in 4NT.INI).
  154.  
  155.    => **  A Ctrl-Enter while scrolling through command history at the
  156.           prompt will now copy the line to the end of the history list,
  157.           even if you don't alter it.  This allows you to force lines to
  158.           the end of the list for easier recall.
  159.  
  160.    =>     You can prefix a command with either @* or *@ to both disable
  161.           aliases and prevent the command from being stored in the history
  162.           (previously only @* was supported).
  163.  
  164.  
  165.    Aliases and Batch Files
  166.    -----------------------
  167.  
  168.    => **  Errors in batch files display the batch file name and the line
  169.           number where the error occurred.  The first line in the file is
  170.           numbered 1.
  171.  
  172.  
  173.  
  174.  
  175.    4DOS/NT 2.5  [10-12-94]        UPDAT25.DOC                        page 3
  176.  
  177.  
  178.    =>     Added ESC as a synonym for R(est) when you're single-stepping
  179.           through batch files with SETDOS /Y1.
  180.  
  181.  
  182.    Command Changes and Enhancements
  183.    --------------------------------
  184.  
  185.    => **  ATTRIB, COPY, DEL, DESCRIBE, LIST, MOVE, REN, and TYPE all
  186.           support the /A:[[-]rhsda] switch (using same syntax as in DIR). 
  187.           This allows you to process files in a variety of ways based on
  188.           their attributes.
  189.  
  190.    =>     ?:  If you use arguments with a "?" command, it will prompt for
  191.           whether to execute another command.
  192.  
  193.    =>     COPY and MOVE allow you to copy files with long filenames to FAT
  194.           drives.  Under Windows NT 3.1 the alternate (FAT-compatible) name
  195.           will be used automatically for the target file.  Under Windows NT
  196.           3.5 and above the long file name will be used for the target
  197.           (Windows NT 3.5 and above support long filenames on FAT drives).
  198.  
  199.    =>     DIR has several changes:
  200.  
  201.               * To support long filenames on FAT drives under Windows NT
  202.               3.5 and above, DIR output now defaults to HPFS / NTFS format.
  203.               To see output in the old FAT format use the /Z switch.
  204.  
  205.               * File sizes are displayed with commas (or the thousands
  206.               separator for your country code) when using the HPFS / NTFS
  207.               display format.
  208.  
  209.               * Summary totals for files and directories are now listed
  210.               separately.
  211.  
  212.               * /B strips trailing spaces to avoid extra characters in
  213.               redirected output files.
  214.  
  215.               * /E and /L will change the case of NTFS and HPFS filenames.
  216.  
  217.               * /T will no longer suppress the display of descriptions;
  218.               instead, descriptions will be displayed after the attributes.
  219.  
  220.    =>     DPATH has been removed from 4DOS/NT as it served no function
  221.           there.
  222.  
  223.    =>     DRAWBOX supports BRIght FILL colors.
  224.  
  225.    => **  FFIND is a new command for quickly finding files or text within
  226.           files.  It can search anything from a single directory to all the
  227.           disks on your system in a single command, supports wildcards in
  228.           the search text, and offers a range of options to customize the
  229.           search.
  230.  
  231.  
  232.  
  233.    4DOS/NT 2.5  [10-12-94]        UPDAT25.DOC                        page 4
  234.  
  235.  
  236.    =>     FOR has a new /H switch to skip the "." and ".." directory
  237.           entries in a wildcard scan.
  238.  
  239.    =>     INKEY and INPUT have two new switches.  /X skips printing a CR/LF
  240.           after echoing the key or line typed by the user; /D allows only
  241.           digits (0-9) in the input.
  242.  
  243.    =>     INPUT has a new /N switch to disable the display color specified
  244.           by InputColor in the .INI file, and use the default display
  245.           colors.
  246.  
  247.    =>     KEYSTACK automatically inserts scan codes as well as ASCII codes. 
  248.           This replaces the cumbersome approach of multiplying the scan
  249.           code by 256 and adding it to the ASCII code.
  250.  
  251.    => **  LIST supports several new options:
  252.  
  253.               * Wildcards can be used in text search strings.  For example
  254.               you can use "to*day" as a search string to find the next line
  255.               with "to" followed by "day" later on the same line, or
  256.               "[14]01" to find the next line containing either "101" or
  257.               "401".  You can disable wildcard searches by prefixing the
  258.               search string with a single backquote [`].
  259.  
  260.               * Pressing "B" (for "back") displays the previous file.  You
  261.               can go all the way back to the first file.
  262.  
  263.               * The file description (if any) is displayed in the "Info"
  264.               box brought up with the "I" key.
  265.  
  266.               * The "G" (goto) command in hex mode prompts for a hex offset
  267.               rather than a line number.
  268.  
  269.               * The P(rint) option asks if you want to print the entire
  270.               file or the current page only.
  271.  
  272.    =>     LOG displays the log file name if you don't enter any arguments.
  273.  
  274.    =>     MOVE has two new switches:  /M only moves files with the archive
  275.           attribute bit set; /V checks that the data is physically
  276.           accessible after the MOVE (like COPY /V).  Also MOVE is slightly
  277.           faster in cases where the target file already exists.
  278.  
  279.    =>     ON ERROR will no longer display the error message before
  280.           executing the specified command.
  281.  
  282.    =>     PROMPT has two new prompt characters, $m and $M, to display the
  283.           time in hours and minutes only.  $m displays in 24-hour format;
  284.           $M uses the default country format.  These are similar to $t and
  285.           $T, but do not display seconds.
  286.  
  287.  
  288.  
  289.  
  290.  
  291.    4DOS/NT 2.5  [10-12-94]        UPDAT25.DOC                        page 5
  292.  
  293.  
  294.    =>     RD /S is much faster if the directory you are removing does not
  295.           exist.
  296.  
  297.    =>     REBOOT /L performs a Logoff.
  298.  
  299.    =>     REM can create an empty file with the syntax "REM > file";
  300.           previously this did not work if there was a space after "REM".
  301.  
  302.    => **  SELECT has three enhancements:
  303.  
  304.               * The L key will call LIST with the current highlighted
  305.               filename.  This allows you to view a file before deciding
  306.               whether to select it.  Exiting LIST will return you to the
  307.               saved position in SELECT.
  308.  
  309.               * The left and right cursor keys will scroll descriptions
  310.               which are longer than the current screen width.
  311.  
  312.               * The new /H switch will hide the "." and ".." directory
  313.               entries.
  314.  
  315.    =>     SETDOS has two changes:
  316.  
  317.               * The new /Fx.y switch sets the minimum and maximum decimal
  318.               precision in @EVAL.  Also see @EVAL and the new EvalMax and
  319.               EvalMin directives in the .INI file.
  320.  
  321.               * You can disable all cursor shape changes normally made by
  322.               the command processor by setting either of the /S arguments
  323.               to -1.  This is primarily intended for those with laptops who
  324.               have other programs controlling the cursor shape.
  325.  
  326.    =>     START supports the /SEPARATE option to start a Win16 app in a
  327.           separate virtual machine (Windows NT 3.5 and above only!).
  328.  
  329.    =>     TEE has been rewritten and is much faster.
  330.  
  331.    =>     WINDOW has a new "SIZE=rows,columns" option to change the console
  332.           screen buffer size.
  333.  
  334.  
  335.    Variables and Variable Functions
  336.    --------------------------------
  337.  
  338.    Enhancements to Existing Variable Functions:
  339.  
  340.    =>     @ATTRIB:  If you only specify the filename, @ATTRIB will now
  341.           return the attributes for that file.  The format is the same as
  342.           that for the ATTRIB and DIR commands: a five-character string of
  343.           the form "RHSAD", with any non-existing attribute bits replaced
  344.           by an underline (e.g. R__A_).
  345.  
  346.  
  347.  
  348.  
  349.    4DOS/NT 2.5  [10-12-94]        UPDAT25.DOC                        page 6
  350.  
  351.  
  352.    => **  @EVAL now supports integer exponentiation with the "**" operator,
  353.           and decimal precision and rounding.  You can set the precision
  354.           for a single calculation with the construct
  355.           %@EVAL[expression=x.y], where "x" specifies the minimum number of
  356.           decimal digits in the result, and "y" specifies the maximum.  To
  357.           set the default precision for all calculations see SETDOS /F and
  358.           the EvalMin and EvalMax directives in the .INI file.
  359.  
  360.    =>     @FILEOPEN has a third parameter; the new syntax is
  361.           %@FILEOPEN[filename,read|write|append[,b|t]], where "b" means
  362.           open in binary mode, and "t" means open in text mode.  Text mode
  363.           (the default) should be used to transfer text data with @FILEREAD
  364.           (without a read "length", see below) and @FILEWRITE.  Binary mode
  365.           should be used to transfer binary data with @FILEREAD (with a
  366.           read "length") and @FILEWRITEB.
  367.  
  368.    =>     @FILEREAD has an optional second parameter to set the number of
  369.           bytes to read.  The new syntax is @FILEREAD[n[,length]].  If the
  370.           length is not given the next line is read, as in the previous
  371.           version.
  372.  
  373.    =>     @FILES, @FINDFIRST and @FINDNEXT now accept a dash [-] in the
  374.           attribute list.  The dash reverses the meaning of the following
  375.           attribute, for example "-d" means to include all entries except
  376.           subdirectories.
  377.  
  378.    => **  @FINDFIRST / @FINDNEXT have several changes:
  379.  
  380.               * Include lists are now supported.
  381.  
  382.               * The filename passed to @FINDNEXT is ignored, and the name
  383.               passed to the last @FINDFIRST is used instead.
  384.  
  385.               * The "." and ".." directories are no longer returned by
  386.               these functions.
  387.  
  388.               * You must call the new @FINDCLOSE function (see below) after
  389.               the last time @FINDNEXT is called to avoid running out of
  390.               directory search handles.
  391.  
  392.    => **  @WORD has an optional new first argument; the new syntax is
  393.           @WORD[["xxx"],n,string], where "xxx" specifies the delimiters you
  394.           wish to use.  To include a double quote ["] within the delimiter
  395.           string, preface it with an escape character.
  396.  
  397.    New Variable Functions:
  398.  
  399.    =>     @ALTNAME[filename]:  Returns the alternate (8.3 FAT-format)
  400.           filename for a file on an NTFS drive.
  401.  
  402.    =>     @COMMA[n]:  Inserts commas (or the "thousands separator"
  403.           character for your country ID) into a numeric string.
  404.  
  405.  
  406.  
  407.    4DOS/NT 2.5  [10-12-94]        UPDAT25.DOC                        page 7
  408.  
  409.  
  410.    =>     @FILESEEKL[handle,line]:  Seeks to the specified line, allowing
  411.           you to do a subsequent @FILEREAD[] without having to loop through
  412.           the lines first.
  413.  
  414.    =>     @FILEWRITEB[handle,length,string]:  Writes the specified string
  415.           to the file; does not append a trailing CR/LF.
  416.  
  417.    =>     @FINDCLOSE[filename]:  Closes the search handle opened by
  418.           @FINDFIRST.  Must be used after the last time @FINDNEXT is called
  419.           to avoid leaving a directory search handle open.
  420.  
  421.    =>     @FORMAT[[-][n][.n],string]:  Formats a string by padding or
  422.           truncating it to a specified length, with right or left
  423.           justification.
  424.  
  425.    =>     @IF[condition,true,false]:  Returns the "true" parameter if the
  426.           condition is true, or the "false" parameter if it is false.  The
  427.           conditions are the same as those for the IF command.  For
  428.           example, %@IF[2==2,Correct!,Oops!] will return "Correct!".
  429.  
  430.    =>     @MAKEAGE[date[,time]]:  Returns a number in the same format as
  431.           the %@FILEAGE function.  This allows you to compare the age of a
  432.           file to a specific date, for example:
  433.  
  434.                   if %@fileage[file1] lt %@makeage[10-1-94,12:00] echo Old!
  435.  
  436.    =>     %@REXX[expression] calls the REXX interpreter to execute the
  437.           expression, returning the result.  If you precede the expression
  438.           with an "=" sign, @REXX will parse the expression and do variable
  439.           expansion, but will not execute it.  In this case the expanded
  440.           value is returned, for example "%@REXX[=date()]" returns "1 June
  441.           1994".
  442.  
  443.    =>     @TIMER[n]:  Returns the current split time for the specified
  444.           timer started with the TIMER command.  "n" can be 1, 2, or 3.
  445.  
  446.    =>     @WORDS[["xxx"],string]:  Returns the number of words in the
  447.           specified string.  The optional first argument is a list of
  448.           delimiters as in @WORD (see above).
  449.  
  450.  
  451.    New Internal Variables:
  452.  
  453.    =>     _BATCHLINE:  Returns the current line number in the current batch
  454.           file.  The first line is numbered one.
  455.  
  456.    =>     _BATCHNAME:  Returns the full path name of the current batch
  457.           file.
  458.  
  459.    =>     _DNAME:  Returns the name of the description file.  The default
  460.           is DESCRIPT.ION; the name can be changed with the DescriptionName
  461.           directive in the .INI file.
  462.  
  463.  
  464.  
  465.    4DOS/NT 2.5  [10-12-94]        UPDAT25.DOC                        page 8
  466.  
  467.  
  468.    =>     _KBHIT:  Returns 1 if a keystroke is waiting in the keyboard
  469.           buffer; 0 if not.
  470.  
  471.    =>     _PIPE:  Returns 1 if the current process is running inside a
  472.           pipe; 0 if not.
  473.  
  474.  
  475.    Technical and Compatibility Enhancements
  476.    ----------------------------------------
  477.  
  478.    =>     F1 will now skip past a leading "*" or "@" on the command line
  479.           when looking for the command name.  This allows you to use
  480.           context-sensitive help even when the command is prefaced with "*"
  481.           or "@".
  482.  
  483.    =>     4DOS/NT no longer does any case conversions in Windows NT 3.5 and
  484.           above (e.g. converting file names to lower case in DIR output). 
  485.           This change is for compatibility with the new FAT drive long
  486.           filename support as implemented in Windows NT 3.5 CMD.EXE.
  487.  
  488.    =>     4DOS/NT now saves the screen buffer size before running an
  489.           external application, and restores it when the application exits.
  490.  
  491.    =>     4DOS/NT now has its icon built in to the .EXE file.
  492.  
  493.    =>     4NT:  Added support for COPY /V and MOVE /V.  4DOS/NT will verify
  494.           that the output file is readable after the copy, but does not
  495.           actually compare the input and output files.
  496.  
  497.    =>     Added support for DOS programs which change the current
  498.           directory.
  499.  
  500.    =>     Improved support for non-English character sets.
  501.  
  502.  
  503.    Bugs Fixed
  504.    ----------
  505.  
  506.    =>     An INKEY /K would disable a wait (/W) once a key had been hit,
  507.           regardless of whether the key was in the /K list.
  508.  
  509.    =>     Batch file line prompting (SETDOS /Y1 and the new ? "xxx"
  510.           command) would prompt even if you were using a pipe and were
  511.           unable to respond.  Now it only prompts if input is coming from
  512.           the console.
  513.  
  514.    =>     Fixed a problem with multiple nested .AND.'s and .OR.'s in an IF
  515.           / IFF statement.
  516.  
  517.    =>     SET /R and ALIAS /R line continuation did not always work
  518.           properly.
  519.  
  520.  
  521.  
  522.  
  523.    4DOS/NT 2.5  [10-12-94]        UPDAT25.DOC                        page 9
  524.  
  525.  
  526.    =>     COPY had several glitches when copying to and from named pipes.
  527.  
  528.    =>     DETACH now handles redirection (|, <, >) and conditional commands
  529.           (&&, ||) properly.
  530.  
  531.    =>     LIST had trouble when piping a large file to LIST /S.
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.    4DOS/NT 2.5  [10-12-94]        UPDAT25.DOC                       page 10
  582.